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Congratulations ... 

We congratulate you on your purchase of a Commodore PET com- 
puter and welcome you to the growing legion of PET users. 

The number of applications for the PET is as great as your imagina- 
tion and the number of programs available. 

We shall attempt, in this modest booklet, to introduce you to the art 
of doing your own programming and to the PET method of using 
prepared programs. 

We do recommend you to the brief bibliography in this booklet's 
appendix. Enjoy learning about your PET and the world of com- 
puters as much as this booklet's authors did. 

By the time you're through with this booklet you should be on your way 
to enjoying and using your PET to its fullest. 

Unpacking your PET 
and turning it on 

Please check the carton for any special unpacking instructions. 

And examine carefully your P17 for any concealed damage. If there is 
any, report this IMMEDIATELY to both ('commodore (or your 
dealer) and to the shipping agent. 
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Free for 



Remove your PET from its protective shipping carton, and place it on 
the counter, desk or other suitable surface, then plug it into any 
standard, grounded electrical outlet. 

Push the rocker switch, in the lower left rear where the line cord 
enters the unit, to the power-on position. 

Momentarily you may be able to see that the PET television display 
contains a collection of random letters and symbols. This is normal. On 
"Power up," PET's electrical circuits have to wake up slowly before they 
can function and clear the screen. 

Almost as fast as you can blink an eye, the screen will clear and one of 
the two messages below will be printed out in white letters on the black 
screen. The second line of the message will vary depending on 



which memory option of PET you are using. It tells you how much 
memory space is free for you to use. 



4k power-on display 






8k power -on display 



1167 BYTES fnet 

READV 



{A byte is the fundamental data element of the PET computer 
and corresponds roughly to one letter or digit of information. 
For the curious: the 4k model should show - in theory 

"4096 bytes" and the 8k, "8192 bytes. "But a few hundred 
are used' by the PET internally. The balance shown "3071 
and "7167" are net available bytes.) 

If you fail to get the power-up display the first time, try turning the 
power switch slowly off then back on. Rarely will PET fail to respond 
to this, but if it does, turn to the Hints if You Have a Problem section 
at the back of this pamphlet. 

Most noticeable in the display is a flashing white square called a 
cursor. Whenever PET is waiting for some keyboard information, 
the cursor will begin blinking and this is where the next charac- 
ter will appear if it is typed in. 



Touring the keyboard 

But, before you can speak to your PET, we need to take a brief 
tour of the keyboard. 

Each key has a thin, transparent plastic film covering the keytop 
which should be removed. This protection was left in place to 
protect the keys against scratches during shipping. To remove the 
film, carefully peel off with your fingernail. 

Key top legends bear much resemblance to those of a standard 
typewriter keyboard, but there are a few differences. 



The letters are all in virtually the same place as on a standard 
typewriter keyboard, but, for your convenience in numerical 
computations, the numbers are separate and laid out very much 
like a calculator keyboard. (See Figure 1.) 






Wf^rQ 






^1 1^ i# 




Figure 1. The keyboard 



On most typewriters, if you strike a letter key, without shifting, 
you win get a lower case letter. On your PET, if you press a letter key 
without shifting, you will get the capital letter. (See Figure 2.) 



J 1 


HWS^ 


**.-iJ. M*.^ s,jui...i:i„«*.,a.. 


1 ws 


ff-' 




■• ^n ^M ^n 1 a . ^^ * • 
^[ c . ^n ^n ^n i ^ 


^ m P^ nn 


".•.:d 




HBfflH 


IfanP- 


^ 



Figure 2. The characters without shifting 

If, on the other hand, you simultaneously press the shift key and a 
letter key, you will get the particular graphic that appears above the 
letter: (See Figure 3.) 

The graphics characters are a special set of symbols unique to PET. 
They are used to draw pictures and lines on the screen and to perform 
simple animation. The graphics can be printed on the screen just like 
any other letter or digit. 

key and press it a number of times to get a 
For now, locate the i^ 
row of characters-XAAAA -on the screen. (Do not use the I 

^ SHIFT 

key. If you did, you'd get l .) ^ 







Flaunt, Th^ciwncle** Willi thfl[w^key in use 



Next, press the j imtI key fTj on the keyboard illustration 

(above). Type a different iSier. Then press '^*^ again. Did you 
see the character erase? 

(P'to again, without sliifting, you're getting DELETE. Sliifting 
would get you INSERT.) 

Play a little game where you type in more letters and DELETE them 
too. 

Remember that no matter what key you press, there IS no way tO damage 

the insides of your PET by normal keyboard operation, f Of course, PET 

is not intended to survive hard falls or attacks with sharp objects - but 
with normal care it will give you years of service.) Do not ever be afraid to 
experiment. 

Test out the keyboard by trying the following sequence of key- 
strokes. Don't worry about making typing mistakes; you already 
know how to correct them. 

Exercise 1 - Testing the keyboard 



H I ll^ACl P i T [RETUfJHI 

The RETURN] key is a special signal to PET that you have finished 
typing a line and it should do something with it. This feature allows 
you to edit the line and get it correctly typed before your PET can 
act on it. 

The important thing about this exercise is to get the following dis- 
play on the screen after you've done: 



3SVNTAX ERROR 



lit i r yny wi^ . FET 1i IkMt ■■■^■^ iti^Y Li cton iiot 

cififkiifllly r^r mtiitiii| the m^murcci of r QDmpuit-r quickh^' aniJ 
raMlv ivaikbj? to clitisc with r\u prfvkmt ^sj^pienu-if . "Symi*'' H^ 
oTiLfaarir. The *jinf mml y^iu t?iianmi:i*cej *hrn ilLMl^ininmnnur: 
iE ftftn Eu the tyloof bnituj^- Si>. "%nti^ Enor" muMfmi 
havtm^e foUowigiJ the riJl^ ekacEly. And, in BASICq >^jh' mwf f^ 

fTfliI 



Exercise 2 — Using the cursor 

(... and inlrodyction to screen editing) 

By tllk EirriE! ynu luvc pnitKLbLy fuLind EKaE £if I'oii ^r^ npt i typl?-! 
e^f even jfyou jff Me % Mimi^ELm^i cfmlttrn^np. la %My I hi? iraj^^to- 
tj'pr Jinrs irir«iT^ yvur I'l I cfirreclly iKt^ Sin! lime Sure, vqu cjti mc 
the h*™^! key to erase the last character typed, as we explained 

earlier. But what if you typed something wrong at the beginning of the 
line? You could delete characters back to that point, then retype. 

But there is an easier way: PET has a feature called screen edit 
which allows you to move the cursor to any position on the line and at that 
point either insert, delete, or retype. 

{The movement of the cursor is non-destructive to the characters 
over which it passes. The characters will not be deleted or changed 
as you more the cursor around on the screen.) 

Locate this row of keys on top of the right hand numeric keypad. 



HCHE 




I 
CURSOR 




OJftSOA 




Wt 



These are all double function keys, their action depending on 
whether or not a i shift] key is used. Press the labeled 



CLR 
HOME 



key top. See the cursor move to the top left corner of the screen'? This 
is the "HOME" position. 
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The same key pressed while the 
screen. Hold down 



iMlFf 



Hl>gT key is pressed clears the 
this time and then press 



HOME 



If there were any characters on the screen, then they were all erased ... 
or "cleared." 



Both functions of 
this key affect the 
screen. 



CLft 



Wiiti SHI Ft - KTivn lj dm 
4iKi £Uf!UE nhaawd.. 



HOME -if— WnJiDul SHIFT -^KTwraimimMj 

! wd cunw n brttwd. •^I 



The best exercise to learn the individual cursor movement keys is to 
move the cursor right, down, left, and up in a sort of circle path to 
return to the original starting position. You will move the cursor on 
the screen in a path like this: 




Tp FiKiv^ from © 10 ® pfp^w thr 
Fl5f pciinca @ to @ pticia 



ajn»n 



kry 3«v«nil t 



t^wP 



cuman 
I 



. Hie npitliindrti twd sJdes df 



Lhe mo-Vtrmcril raqutftf tBtf af the fMtFTl Key. Mo-W tTOm ® W- 
by hroldtFlpc 6\y%m I WIFtI nild |^«fln|; I CIMHM !- 



( 



(If you press the last key too many times and wind up in position you 
have discovered another feature called "wrap-around" which has 
moved the cursor to the end of the previous line. Type 

without the shift key held down to move the cursor 



cypimi 



The home sEi«tcli fmm {?] to f¥^ ii caiv^ You em ?iTlltf W\^ A^"^ 






ruppfti-ddly ttntj] the c^judj it m posif icnia 



rwipf ] ind type 

I of rvtw ij^l OTTpTloimavc I he cunwir " HC)ME " Try W tupth 



I 



ways. Try moving the cursor around the screen between two arbitrary 
points. Practice until you are confident you can put the cursor where 
you want it on the screen. 



Exercise 3 - Using graphics 

If you have accomplished moving the cursor, then you can use your PET 
like an electronic sketch pad. The characters on the upper half 

of each keytop are called graphics. When you hold down the [bhiift ] 
key as you type, the graphics are printed instead of letters or 
numbers. 

Now let's draw a figure that should look very much like this by the time 
we get through. 




Figure 4. Rocket drawing using tlie grapliics Iceys 



Follow the instructions exactly as shown in the diagram that follows: 



Rtmtmtn'f ^hf 



NOME 



iimi I MifTi A:r;'i7 Uxr flj^i** A^v? rtnw 



to clear the screen. 



Move the cursor to the right 6 spaces: as shown in the diagram. 
Press I SHIFT I and type the graphics. Now you use the cursor keys 
to get the cursor in position to type the next line. 
NOTE: Shaded keys are keys that must be accompanied by 

pressing the I shift \ key. 
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CB^L % 



Ifl 



LINE 



& Cn tS E33 GB 



rM-ll TieW lifltf.l 



C=^ 



l{=]l 



9? ti 

Figure 5, Griphta k8V» tJa*d t" dr«w rock«l 



. 'VOTE: Do not press \ hlT uP-nJ at an t^ time in this exercise. 
Your PT,-Twill think you'vejinished, it will not understand and 



TSVNTAX ERHON 



If this happens, first clear the screen again and start over. 

When your rocket is complete, move the cursor to the left edge 
of the screen at line 10. 

Now type new 



RETUHN 



The Cursor should be in the left part of your screen when you've done 
all the above. 



Exercise 4 - Creating a program 

When you have finished this exercise, you will have drawn a pic 
ture on the screen. You probably went to a lot of work to create this 
picture. You'd like to preserve it so you can view it again. 



So let's turn each line of the picture into a program step and see 
what happens. 

The importance of a program to a com,puter can he likened to 
the im,portance of a driver to a car. The car does nothing with- 
out a driver and the com,puter does nothing without a program,. 

A program, is stored as a list of steps or instructions in PET's 
m,em,ory. Before we can create a program, in its m,em,ory, we 
should m,ake PET forget about any previous program,. This is 
what we did when we typed the word NEW. Use the command 
any time You want to enter a , NEW program,. 



P^ew the 



^kM 



key. Mike ibscikitely lure yQU do nor pfcsi 



1 wiFTj Y^u want the cumn En the "HOMli'" pCKhtbn. 



Now type 



I 



The number 1 tells PET "This is 



the first thing to do." The ? tells PET to print, and the quotes tell 
PET to print a MESSAOIJurn I 

(If you m,ake an error, do not try to correct it. Instead 

press f RETURN I, then m,ove the cursor up and type the co rrect 
number, the question m,ark, and the quotes. Then press 



HETLIHW J 



^ow type [T][T] ^^ I REtuHM \ . jiw I \t\\% Ph i ihfti ihji hi the 
iticunct thing !□ ijp, 

ffflT ihc third line. %y\^ EIDC^L^ farrijHw] , and for I tit Tourth 



liric. iyp<? 



*1r 



RETURN 



] 



Notice that the only thing that changed has been the number (1,2, 
3 and 4) that tells PET "this is the th thing to do." So now tell PET 
the 5th, 6th. 7th, 8th, and 9th things to do, just like we've done with 
the first four. Be sure to keep the numbers in the right sequence. 

Stop when you reach the line containing the word "NEW," because you 
don't want that word included in your program. Using the 



ClulMA^ 



key, move the cursor down the screen until it is below 



the word "READY." Would you believe you've just created a 
computer program? 



Exercise 5 - Listing and running your 
program 

Clear the screen and type: 

LIST 



niTunN 



LIST is a command to your PET to print the lines of program stored in 
memory onto the screen so that you can look at them. You should see 
something like this on your screen 



1 PWWT" 

2 1"HIWT" 
;) PNIMT" 

4 PRINT-' 

5 PfliNT" 

6 PIIIMT" 
1 PRINT" 
■ PRINT " 
fl PRINT" 
READV 



The ? that you have typed in as a shorthand for PRINT has been 
expanded out in the listing. Other than that, everything should be as 
you typed it in. If there is an extra line which should not be there, it 
may be deleted by typing just the number of the line 
followed by ftETUiiN | . 

LIST your program again if y ou wish. W hen everything is just as you 
want it to be type run [ AEf uhn 



There! Your picture will appear on the screen. RUN tells PET to 
execute the BASIC program you have entered, starting at the lowest 
line number step and proceeding with subsequent steps in ascending 
line number order. 



Exercise 6-Amending the program 

RUN your program again. If you did not clear the screen first, you may 
have seen the old rocket disappear at the top of the screen and the new 
rocket roll up from the bottom of the screen. 

This phenomenon is called "scrolling." When PET is printing in the 
bottom-most line of the screen, everything moves up rather than the 



cursor moving to a lower line. PET cannot scroll the other way, 
however. Information that scrolls off the top of the screen is lost. 

We can use this scrolling effect to our advantage to produce an ani- 
mation in which it appears as though a stream of rockets are blasting 
off from the bottom of the screen and are streaking off the top. To 
do this we will learn a new BASIC language command. 

Type this line in 



1 » f i^"Pa«i SOTO wgen i • 

The line number (100) was chosen so that it would be greater than any 
you had used previously and thus would be the last step of your program 
to execute. 

GOTO is a BASIC command to break the sequential execution of 
statements and "go to" the line number specified. If you entered the 
rocket picture with line numbers exactly as shown, line 1 is the first 
line of the program which prints the rocket picture. Change the target 
line of the "go to" to correspond to your first line number if it is not 
line 1. The effect of line 100 is to repeatedly print the rocket and scroll it 
off the screen. 

But, because we don't want the rockets to be touching nose to tail, we' 
d like to add some space between them. When we typed LIST, we 
noticed that the last line number was 9. (We've since added line 100). 
Any numbers greater than 9 and smaller than ^qo will be positioned 
correctly in line number sequence by your PET. So let's add the 

statements: If r »- 

11 ? - 

Maw Ifft^B L 1ST enct mtnc: 



3 ftciprt* 

4 PRIMT- 

5 ffll-NJT" 

i mmr- 

I MlMt- 
H Pftiirr- 
s pniRfT" 
li ™iMT" 

II pmuT 
u nmr 



Now type RUN. As soon as you press I aetuan 
your program. ' 



PET will execute 




Rockets should be flashing on the screen so fast that it may be 
difficult to see them. The speed at which characters are printed on 
the screen can be controlled while the program is running by 

pushing the key OFF , Hold this key down while you watch the 
RVS 

screen. Now, release the key. Use of this key reduces the printing 

speed to about 2 lines per second. 

The program you have created contains what is called an "infinite 

loop." Statement 100 does not contain a condition to stop 

running the program and cease printing the rocket, but 

unconditionally goes to the start of the program over and over. It will 

continue like this forever unless you pull the plug. 

(Pulling the plug or shutting Off the power-on switch not only 
stops the program, it also destroys the program statem,ents. You ' 
ve put in a lot oftim,e typing theta and stay not want them, 
destroyed.) 



PET hiK a My m pfth: [^ ™^ ^^ ^ ^"^^P ^^^"*^°" "^^"" y°" 

do not press the SHIFT key. This will effectively "pull the plug on this 
program, without losing the program statements. 

PET will respond with something like: 

BREAK IN LINES 

This message means that execution of your program was stopped when 
it reached line R (or whatever line it was in your case) because 
you pressed the^. 



ftUM 



key 



At this point you m,ay want to save your program,. See page 31, " 
Using your Cassette to Save a Program,. " 

Exercise 7 - Screen editing 

One of the handiest features of PET is the ability to modify easily 
the program you have entered, as we have just seen. 



12 



You can change a single character or you can add characters to lines you 
already have. You can see exactly what you are changing because the 
changes are visible as you enter them. 

Let's try it. 

(But before We start a new program,, let's type new and press 



BITUIWI j . 



/ tits is im,portant: it clears aft previous program,s in 



your PET and thus avoids any confusion.) 
Type in: 10 PRINT "HELLO, HOW HOW ARE YOU?" 



RETURN 



We have one too many HOWs in the line. Let's type LIST so we can 
see the line on the screen. 



10 PFIINT HELLO, HDW HOW ARE VQU?' 
REAOV 



Now jif tfii 



9HIFT 



4Jld \ CUH50H • Ci*[?cllMer. RepcBr 



This will move the cursor tip two lines from its lower position to the 
first position of line 10. 



^kl* pre- 5^ 



mnscii 



cwirhnii! ihff y^ifjQ Ittj^lHevetal tuftct until il 



is over the space after the W in either one of the HOWs. 

New ffma nSJn * ^LTTii:^. T\w ^-xtra HOW m\6 ^ spm^jlr ate pyf\t\ 



QtL 



PiPM I iWTtlflM I tci tell vc^uJ- PFT you've finisdicd cJitin# [lii> Un*. 
Now piTSii cu-Rsan [c^Uft tii- ;i l-"l:ink Uncoil IhticrDcn. Tvemt LIST. 



10 PmWT "KEILO. HOW AHE HQMT 
PEflQY 



You see how easy that was. 

Do the same thing Jl I have eliminated the HOW: 



10 PH1NI HtLLO, Artfe YOUr' 

ntAov. 
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Now let's insert the missing HOW. 

iDjEcthcr. Itepsfll li bf fore. 



Pt«iP [jNiPT i aniJ 



cui 



Now position the cursor over the A in ARE by pressing Ci>BHJfl H 
several times. ^ 



Now pTt3^ I biirri fljid 
I IWIPTJ uid 

ifid 



oa 



Mwr 

OIL 



ISf 

ML 



ML 



Pt4 



Chrn. H 
> ihcnO 
then W 
then 



I-™^ 


JhJ 



ntriLJiiN 



then eijiflfQfl [to get past the READY in the display. Type LIST. 

I 4 
You 



ID PKiNI HtLLD. HDW AHk VQUf 



With editing that easy you need have no fear of making typing 
errors. Agreed? 

Let's try another interesting screen edit. First, type NEW to clear 
out the old program. 

Enter: 



1 P R I N T "ANYTHING" 



ntlURN 



(This time we won't type LIST each time we make a correction.) 
and 



inline #10. 



Press 2 then press 



CuAfiJQR 



so that you position the cursor over 1 



ctmscm 



until it reaches the A in ANYTHING" 



Now type EVERYTHIN G" and pre ss 



■itilfiH 



Now press f khjft | m4 



i 



together so that you position the 



cursor over the 2 in line #20. Press 3 then 



cuAMfl over to the 



K 



E in EVERYTHING and type NOTHING". Press space three times. ( 
Because EVERYTHING is three letters longer than NOTHING.) 
Press [piiTUflN I 
Now type LIST and press nwWHi^T 



You'll read: 



t« PRINT •^AHVTHING" 
» PRINT "EUFnVTHJNG- 

» PfHNT "NOTHING" 



Interesting? Think of the applications. If you want to repeat a com- 
plex statement several tines in the same program ... or if you want to 
change just a part of a statement on one line and enter that 
amended statement on another line. 

Exercise 8 - Using tiie reverse fieid 

Every key on the keyboard, with the exception of a few which we 
shall note, prints almost exactly what you see onto the screen. We 
say "almost" because the screen displays characters in white 



on a black background. There is a 






key which, when pressed. 



causes all subsequent characters to be displayed in reverse 
field - black on white - on that line. 



Type ABC 









AVI 







ABC and you'll see: 




Your PET displays 128 unique symbols which, with the addition of 
reverse field, really adds up to a total of 256 different characters 
that can be displayed. 

Reverse field remains in effect until a) you type RETURN or b) 



lidid Ilt^lr^ the [ftmft f ind t^"|>c1^J 

As an example, type: 

A a C [sHlfT] 



A 6 



AVf 



QFF 



ABC 



Vpytl 



le^OiABC 



1 

5 



Exercise 8 - Programming cursor movement 

Cursor control characters may be programmed into PRINT state- 
ments. It is often desirable to clear the PET display under program 
control. We will do it in a direct statement. 



f " 


E^3| 


CLB~| 

HOMIi 



Note that you did not clear the screen by typing these keys, but that 



the screen 




When you have typed an odds number of quote marks you are in this 
special cursor control character insertion mode. 

( ** I Represents a single quote mark, for this discussion. And one is 

an o dd n umber.) 

Tilt r^s a representation of a CLEAR SCREEN control character. 

Do not type RETURN yet. Instead type 



CLJR^n 


1 


1 

CURSOR 

i 












These printout 


^^^^^^^^^^^1 



which are cursor control characters for CURSOR RIGHT and 

CURSOR DOWN. 

If you now type a second . . you will have entered an even number 



of quote marks and you will leave the special mode. Typing I ^'•KIPI 

will again move the cursor, but this time, without printing anything. 

Any time you want to enter or leave the control character insertion 
mode you may do one of two things: 

Q . press \M^^^ key. Then use 
^1 your cursor keys 

to return to 
fTTT rSiXl t^^ point on 



1 . Enter a second 
Hne ... or 

2. Delete the first 



quotation 



the preceding 



1 
R 



Editing: a Review 



When you press one of the PET's cursor control keys, you may be in one 
of two editing modes, as you have already seen. 

LDIRECr CURSOR CONTROL 

The cursor is moved as soon as you press the cursor control key. 

In DIRECT mode, the User is creating program code. The cursor 
control keys allow the User to insert or delete characters at will 
unless he specifically indicates (by typing a quotation mark) that 
the cursor movement is to be a part of the created code. 

When entering program code, the User can correct typographical 
errors in one of four ways. 

A. Delete all characters back to the error, then retype. 

B. If no quotation marks have been used, backspace (cursor left) over 

the intervening characters until the cursor is positioned over the 
error, retype the character, then forward space (cursor right) to 
the next desired character position to be typed. 



C. If a quotation mark has been used, press 
program Hne. Then move the cursor up 



[ aJTUHM] to leave the 
and over to one space 



pait the ErTnl-_ PlfriSi I'^fTl CodeJcCc tlie^ltm, prew |mift| ami 



[llffT 



Co iTiMTr an ^ifrtirtii. limt iypt* In iK* pnrreMrt dAmimcter^ 



then forward space to the next desired character position to be 
typed. Programmed cursor control is no longer in effect. 

D. Another method is to close the quotes (type the ending quotation 
mark) then backspace to the offending character and retype. 
Again, programmed cursor control is no longer in effect. 

There may be occasions when it is appropriate to lengthen a state- 
ment line. If the cursor is moved to the end of an existing Hne, the 
additional characters may be typed in. The cursor wiU wrap around to 
the next lower Hne if more than 40 positions are used. If the lower line 
contains a program statement, it can be over-typed. Extra characters 
remaining from that previously typed line must be deleted or they will 
be incorporated into the line being edited. 

Original Program 



IQ4»ftlNI "NOW IS THE TIME FOB ALL" 
?D PRINT "THl END" 



Move the cursor until it is, positioned over the closing quotes in 
statement 10, and type _GOOD MEN TO". 



17 



lOPRiNT "HOW IS THE TlUE FOR AtL GOOD » 
IH to- rHCEND" 



itclctc 
ihe 



THf ENO- by 
awr the LhoTKjtcn, umtig 
bur. 



Ndw LtST 



i4i('KlhrT "Hmi IK THE TIME FDR ALL GOOD M 
;J0 PRINT -THEEMD" 



If you wish to insert characters within a statement line, position the 
cursor over the first character to be shifted to the right. 

Pfll^ with the 



DIL 



[SiHIFTI k^y- If the new spaces increase line length to 



greater than 40 spaces, a space will open up between the line being 
edited and the next program line, and the characters to the right of 
the insertion will move into the opened space. This is difficult to 
show on paper, so just follow the instructions and watch the 
result on your screen. 

I . Type this program 

10 PRINT "NOW IS THE TIME TO" 
20 PRINT "THE END" 

2. List the program 

3. Move the cursor to the letter T in the word TO in statement 10. 



4. Hold the 



h hiffJ 



key and press the inlj. r 



[key 



17 times 



(Here's where the screen will show a space being opened between 
statement lines) 

5. Type FOR ALL GOOD MEN T 

6. Press 



WITUH**] 



7. LIST the program again 

Using Direct Cursor Control while coding a string literal: 

To edit a string literal, such as a print message or a data statement, the 
user must press the RETURN key and leave the statement line. A 
literal cannot be edited (except for character deletion and retyping) 
while it is being originated, because all cursor controls except delete 
and insert are programmable. The user must leave the statement line via 
a carriage return, then move the cursor back to the offending 
character and retype. Furthermore, to program cursor controls within 
the string after having left the line, the user must use 
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the I INSERT function to open up spaces into which he can then type 
the appropriate control character. 

The user can, of course, close the quotes, and thereby signal PET 
that he is through with the literal message. However, once the second 
quote mark has been typed, PET will no longer recognize cursor 
movement as a part of created code, and the cursor will move accord- 
ing to the Function represented by the key pressed. 

II. PROGRAMMED CURSOR CONTROL 

The cursor movement is executed during a program run. It is 
part of a PRINT statement and has been enclosed within 
quotation marks. 



Function 

CURSOR UP CURSOR 

DOWN CURSOR LEFT 
CURSOR RIGHT CLEAR 
SCREEN HOME 
CURSOR INSERT 
CHARACTER* 
DELETE CHARACTER* 
REVERSE FIELD 
RESET REVERSE' 



Kvyi Id Pn 



SHIFT 



B 



f^nlA 



3 



tmm 



s^ 

wtrr 














CflHV 



mtn 




DUI \ 
HOHfj 










cut 



m\n 




iHit 

ML 













OCP 



ASCII 

143 

n 

IJ7 
29 

J 47 
19 

14a 
30 
IS 



TRHWuFMtf} 
Chmctar 



C*P 



*The INSERT and DELETE functions are not programmable. Use 
CHRS (20) to delete during program run and CHRS (148) to 
insert during program run. 
PET uses the quotation mark to signal the beginning of a string literal, 
as in a DATA or PRINT statement. When attem^pting to edit a program^ 
line, the User should be aware that if PET sees an opening quote, it 
will consider all cursor movement instructions as part of the 
string. 
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The first BASIC command we shall explore will tell your PET to 
PRINT something on the screen. This is one of the more useful 
commands, for with it you can make your PET display data, draw 
pictures, or play games. 

Now enter the following by pressing this sequence of keys. (We'll 
call it "typing" from this point on.) 



Exercise 10- Printing on the screen 



PRINT "- hello: £Pac£ 



P £ T " 



mpm 



Did your PET print HELLO PET on the screen? If it did not, then try it 
again. PRINT is a command which tells your PET what to do with the 
rest of the line. This example has a message between quotes. The 
quotes tell your PET to print out the message exactly as it appears 
within the quotes without any further processing. 




Exercise 11 - Using the built-in clock 

Now, let us speak to your PET in BASIC and get it to tell you what time 
it is. Your PET has a built-in clock that starts from the moment 
you turn on the computer. 

To discover the elapsed time, type: 



The ? is a shorthand which you may use instead of always typing 
PRINT when you want your PET to print something. The $ at the 
end of the word TIME tells PET to print the time in hours /minutes/ 
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seconds. Though the elapsed time may he different, you should See 






The first two digits .ire elapsed hours, the second two digits arc elapsed 
minutes, and the last two digits are elapsed seconds - which, in the above 
example, means that PET has been running for 00 hours, 1 1 minutes, 
and 30 seconds. The time you see on your PET, however, will depend 
entirely on how long you have had it on thus far. PET's clock is crystal- 
controlled and very accurate. It is also a 24 hour clock which means it 
will count up to 23:59:59 then roll over to 00:00:00. 



Exercise 12 - Setting the clock 

It is very easy to set your PET clock. Assume it will be 12:30 p.m.. in a 
few seconds. Press the following sequence of keys: 

T I M E$=" 12 3 0" 

When the designated time ( 12:30 p.m..) comes up on your watch. 



pi-os' IwmjiHNl and PET will set the time. 

Substitute your current local time and try setting the clock as in the 
previous example. (If the time is 9:30, be sure to type "093000" 
you need 6 digits.) 

Now, whenever you type: 



? T I M E t IflrruRiir 



your PET will tell you the correct time. Remember that if you turn the 
power off, the clock will stop running and you will have to reset it when 
you turn the power on again. Once you have reset it, though, you have a 
highly accurate built-in clock available at all times. Just 

type in ? T I M E s [ B^TliflSr] and there it is. 

Exercise 13- Solving mathematical problems 

BASIC is essentially an algebraic language which means that you 
can use your PET much as you would a pocket calculator. Though it 
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packs the power of several programmable calculators put together, 
it is as easy to use as a simple four-function calculator. Furthermore, 
everything you type into it is instantly displayed on the screen, and 
that makes it easier to keep track of what you are doing. 

To perform arithmetic on your PET, simply tell it in BASIC to print 
your answer. Note how much it looks like a direct question: 



?2 + 2 



RETUHI 



When you press the RETURN key. PET prints the result on the 
screen. 




PET arithmetic is not complex or mysterious. But, like human arith- 
metic, it does have rules. One of the most important rules is 
the order of operation: 



I . exponentiation 

2. multiplication and division 

3 . addition and subtraction 



t (above RETURN key) 

+- 



In direct mode, type: 
?9*3+7*6-5M/3*2 PET 
will respond: 100. 
666667 

You (because you're the one in charge here) decide how to group the 
expression so the result will be correct. You do this with parentheses. 

Type: ?(9*8+7)*6-5M/3*2 

PET says: 460.666667 

Type: ?(9*8+7*6-5)*(4/3*2) 

PET says: 290.666667 



Type: 



?((9*8+7*6-5*4)/3)*2 



PET says: 62.6666667 

Type: ?(9*8+7*6-5*(4/3)1*2 

PET says: 214.666667 

PET does all the work inside the parentheses first, before it does any- 
thing outside of them. Once inside parentheses, PET does 
multiplication and division, then addition and subtraction. After all 
the work inside the parentheses is done, PET moves outside and does 
everything" there. 



Let's look now at some of the arithmetic functions and find out how to 
use them. First, type NEW, to delete the program we were using. Now, 
type these program lines: 

100FOR I = 1to10 120 
PRINT U*I,SQR(I) 130 
NEXT I 

and RUN. 



The result represents I (the count or index), I squared (the * means 
multiply), and the square root of I. SQR(X ) is the Square Root func- 
tion, and finds the square root of whatever number you put inside the 
parentheses. Like all BASIC functions, SQR(X) requires an argument 
any number you choose, enclosed in parentheses. Arithmetic expressions 
can be used if you like instead of numbers, like SQR(5*20) 



All the arithmetic functions are used in a similar fashion. Turn to the 
BASIC keywords (Appendix II) and find the section on Arithmetic 
functions. You can check out the way each one works by substituting it 
for one of the functions in line 1 2Q of the program. The brief 
description of the function, along with actually trying it yourself, will 
show you how to use it. 
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Try using the string functions, too. You'll need a new program to do 
that (be sure to type in NEW first) : 

NEW 

10 FORI = 1 TO 10 
20 INPUT"ENTER A STRING";A$ 30 
PRINT LEN (A$) 
40 NEXT I 

Lines 10 and 40 you already know about. In Line 30, the new item is 
the dollar sign. This tells PET you are entering letters or graphics instead 
of numbers. Line 30 prints the function we selected for this example. 
Since you know your name best, use your name as the data you INPUT 
in line 20. PET should print the number of letters and spaces in your 
name when you RUN the program. PET does count spaces in strings- 
even if that's almost the only place it wants them! 



Now let's go a step beyond. 

First type these lines. Note the comments in italics; they explain 
each niece of the program lines. 



Wl*l-^ 

11f LiT X-ft 
IJSLfT ¥-li 
IMLEI I-X4¥ 

i ^^^ 



4ThL^ iWffiwjtfjI.:/ riimmati's ail //f^^k/cJ, 



7FI.1 



THes^ art 



n^.^ arir 



And fAr.^ u/r uiiframts 
fin thij «ir. fke ^pewMts 



Line 1 10, 120 and 130 are called "assignment statements", because 

they are used to assign values to letters of the alphabet. Line 

140 

is a PRINT statement and causes PET to print the value of the letter Z. 

(PET knows the value of Z because statement 130 told it that Z is 

the sum of X and Y.) 

Of course, this is a trivial program. You've already learned how to type 
^' 5 + 10 and have PET print the answer. But it gets more inter- 
esting as we go along. 

Now, if you RUN this program, PET will print: 
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You, as the programmer, can put any number you like in statements 

110 and 120. You don't have to use 5 and 10. 
It would be cumbersome to have to retype lines 110 and 130 every 
time you wanted to change the numbers. So, PET's BASIC allows you to 
change the numbers during program execution, using the 
INPUT keyword. Let's change the program to show you how to INPUT 
data: 



100 PRINT "ENTER A NUMBER" 
110 INPUTX 

115 PRINT "ANOTHER NUMBER" 
120 INPUT Y 






J^ii €tmirmta ^i M i lium 



Since lines 130 and 140 stay the same, we won't retype them. Here, 
line 100 prints a message. When you run the program, PET will print 
the message so you'll know what you're supposed to do. By using this 
"prompty " anyone can use your program, because he'll 
be told what to do and won't have to guess. Line 110 will force PET to 
wait until you type in a number and press RETURN. 

If you press RETURN without entering any number, PET will think 
you don't want to continue running the program. It will jump out of 
the program and tell you it's READY for whatever you want it to do 
next. Line 115, like line 100, prints a message prompting you to enter 
another number, and line 120 makes PET wait for you to do so. 

Now RUN the program. 
PET will show: 




Type a number-say 23 -and press RETURN. PET prints: 



ENTEFS A«dUMBtn 
ANnTHCdhlLFMftER 



the cursor will flash here'. 
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Type another number— perhaps I " and press RI 1 URN. PET will print 
the answer 35 and say READY. Your screen should look 
like this: 



READY. 

in LIT M-5 

1ZSLET V-lfl 

130 LET 2-X*V 

Hi Pfll»4T Z 

HUH 

i& 

REAfiV. 

104 Pniht "ENTER A NUMSER ' 

li:iPfllNT ANOrHER NUMBER" 

i;0 INPUT V 

HUN 

CHTFH A NUMBER 

.ANOTHER NUh«ER 



lit AD Y. 



t_nr 



cnrmr rti^iiW hr fhx^Um ffr^^ 



Now rf wc tyfL-J I IST. flic- fTfrf!f:jm w^iukl ktok IJltt' lllJjS 



1» INPUT V 
1 la I CT -r. v^v 



t4tPR1NTZ 



Note that your PET automatically places the line numbers in ascending 
order, too. 

Using INPUT makes it easier to check the numbers, doesn't it'? Now 
you just type RUN, and each time you do so. yon can use different 
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numbers. But it you have 10 pairs of numbers, typing RUN each time 
can STILL he tedious! 

So, BASIC has two features which allows you to do an operation (in 
this case, add a pair of numbers) as many times as you like without 
typing RUN. One of these features is the GOTO statement. It forces 
PET to GO TO a line you specify, instead of doing whatever it 
would normally do. (In this case, PET would normally stop and print 
READY when it finishes the sum.) You can do that with this statement: 

150 GOTO 100 

Now PET will print the sum, then go hack to line 100 and print the "E 
NTER A NUMBER" message. Try it. Add up several pairs of numbers. 
When you're ready to go on, just press RETURN without having given 
PI :T any data (numbers) and it will jump out of your program and alt 
patiently for you to tell it what to do next. (You'll see PET's READY 
message and the flashing cursor.) 

The second feature is called a FOR-NE^T loop. It allows PET to 
perform an operation (or a sequence of operations) FOR as many 
times as you Hke. The word NEXT is the last line of the sequence, 
and tells PET that it has completed all the repeatable operations. 

Type these lines. 

90 FOR I = 1 TO 10 
150 NEXT I 

In this example. I is called the "index." PET keeps track of the 
number of times it performs the sequence of operations (lines 100 
through 140) and keeps the count in the index. You set the index to 1 in 
statement 90 and tell PITT to count to 10. Everytime PET reaches 
statement 150 it increments, or adds to, the count, and goes hack to 
statement 90. Then PET checks to see if the number in the index is 
greater than the number of repeats you wanted. If it is, then PET looks 
for something else to do. If the count is less than or equal to the 
number of repeats (in this case, 10), it performs the whole sequence 
again. 

In brief, PET will let you enter a pair of numbers FOR as many times 
as you request. And PET wiU do as much as you ask to each pair of 
numbers before going after the NEXT pair. 
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Exercise 14 - Animating your PET 

It's easy to move an object smoothly across the CRT, thanks to PET's 
programmable cursor controls. The listings below give you the fun- 
damental right-left-up-down motions. Later we wiU show you how to 
program an unidentified flying object. 

Move a ball right & left across the screen. (Note: all symbols are shown 
as they appear on screen.) 



m PRINT "H"'. 
29 FOR J = 1 Tft T^ 

49 NEXT '-' ** "-^ 

50 FOR I = I TO Jl'> 

Movr B tufH vp it down cm the iot«n 

2» FOR I = I TO :4 

4d NEXT L-f LAJ t:^ »* L^ 
SH FOR I ' I TO ;4 

«PRlNT-g(j0n[J]"; 



cl^ar the i£nee:ii * 
izufiar left ball cursor Irft^ 



clr^r the icrreii" 
b^t cunqr tefl* 
i:uF«ir up hflU cul^jr kit* 



Note: While "cursor up" character and "ball" character (the shifted " 
Q" character) look alike, they obviously perform quite different 
functions as you will perceive ... provided you press the right key. 

70 NEXT 
80 GOTO 20 

And, of course, moving a ball diagonally across the screen (top left 
to bottom right) 

|»Pftll^- [S]"h 

:gFORI= 3 TD24 

30 PRINT "n lo] Drii"- 

n FCIK t = 1 TO ;4 

^p«ivr"QQ][]]B[i|-; 



hpmc cur5<]r* 

ball cunOfltrr 

rpsce cynqr kft cunar Igft 



'filter you type, in sequence, a quotation mark and a cursor 
key, you'll see a symbol appear to indicate the cursor movement 
o Q or action. This is a guide to these symbols: 





Pf^T Showi 


KflvHuidi 


rrirnr fitlil haart 


bj 


diear«1«11 


Ifevcnr rwkt rifhr hu^k^X 


I! 


L'unar n|lit 


wwrm rielil dot 


' -■ 


liunor up 


hat) 


D 


Uilftrd g pipKj.- 


TEverif Held cnpiEua Q 


r*Ji 


cunor 4Jow;i 


ftvi^nt- nehJ Lapilal ?t 


m 


bomecyrwf 


rcvgin? field iquirc witli line inphk 


LJJ 


curfor lefl 


^P&IDC 


n 


V^-MSii 



Using your cassette 
to save a program 

After the effort of entering and debugging your BASIC program, 

you may want to save it on cassette tape for later use. 

Place a blank cassette in the recorder unit, and press "REW" to be 

sure the tape is fully rewound. When rewinding is complete, press " 

STOP" on the cassette unit. You are ready now to save your 

program. 

It's a good idea to save your program by name. Having completed the 

rocketship drawing and converted it to a program, let's save it, 

using the name "ROCKETSHIP." 

ILILIIIM IiHiPIIIIBiRN. PET will display: 




Press the correct buttons, and the display reads: 




Now, when PET is ready, and the cursor flashes, you should rewind 
the tare and verify that your program really did get saved. When the 
tan, is fully rewound tune the word VERIFY and press IritlphjjI 

PET will tell you which cassette unit button to press. Do so, and 
PET will assure you it is VERIFYING. Then, when PET is READY, you 
now can be sure your tape has an accurate copy of your program. 
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If you see VERIFY ERROR, rewind your tape and try it again. If you still 
get VERIFY ERROR, save your program and start over. (Note: be sure 
to use music-quality low noise cassette tapes.) 

You can use any name you like for your program. Because your PET 
will only display 16 of the characters used in a program name, you'll 
probably want to keep the names short. 

When you name your programs, remember that PET doesn't need to 
have the whole name typed on the keyboard in order to find it, when 
you ask PET to load it. If you name your program "ROCKETSHIP", you 
may ask PET to LOAD-ROCK" and it will find the right program and load 
it. This means you must he careful to avoid naming one program "ROCK" 
and another program on the same tape "ROCKET". PET won't know 
which is which, and will load the first program with the letters ROCK in 
its name. 

You do not need to incorporate the program name into the program 
itself. PET saves the program name in a file header when it saves the 
program, and that the only identification it looks for. 

This means you can save your program in small pieces as you write it. 
You may find it worthwhile to SAVE your work every 20 to 30 lines 
or so, to avoid losing it in event of a power failure. But, since you may 
not want to type the full program name each time, PET is designed not 
to REQUIRE: a name: 
Type SAVE and press [mtijllMj • PET will display 



PRESS PlAV h RECOnO ON TAPE - T 



and_ when you do so. PET will show 



PRtiS PLAV fr AECORP ON TAPE " T 
WRITING 



And as soon as the program is saved, PET will add the word READY 
to the display. 

You may want to save your program more than once on the same tape 
to be sure you have a good copy. As cassette tapes age, they 
frequently stretch or wrinkle, especially at the ends. A second, or 
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even a third SAVE may prevent loss of your program and will prove to he 
worth the extra few minutes it takes to save and verify the extra 
copies. 



Using your cassette 
to load a program 



The built-in cassette drive in your PET computer is your easy access 
to a library of BASIC programs, either created by you or purchased 
from the extensive COMMODORE library. 

PET is like a pocket calculator in that it forgets everything when you 
turn the power off. (Remember what happens to time) That is why 
PET has a built-in cassette drive. Programs can be saved on tape 
before power is turned off. They may he restored to PET's memory 
when power is turned on again. 

Take a cassette, open the cover, and place the cassette in just as 
you would a normal audio cassette. Do not push any cassette keys at 
pi is time. 



Now, hold down the 
key. If you see: 



PRESS ^LAV ON TAPt »t 

PREAK 

READY. 



■NIPT I key and touch and release the ^^^ 



STOP 



Mirr 



then yfHi>e rrioiey Ih* ^ ^ 



liry ^rfnnf you mlflKcl tlK 



mm 



HpW Iht [ iwiPT ] k ey iJq^n . fai*eh and rek-uH: ihe ^|^ 'key, N&w 
you can r^Icai^hf | mmwj \ fcey. t I 
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I 



If you've done all *^' ^^""^^^^^ ^^^ '^^^^^ see: 



PRESS PLiSiV Oh TAPE ^1 



Pressing the | nyw and the [^j^ keys caused the command LOAD 
to be typed on the screen and PET responded by asking you to 
operate the cassette. 

(If you wish, you can also tell your PET to load the program by 
typing in LOAD and [ wetuum \instead of the above procedure.) 

Press the key labeled "PLAY" on the cassette unit. 
Your screen should now display: 



LOAD 

PRfW PLAY ON TAP€ »1 

OK 

EEaACHJNhQ 



NO 



This means your pressing of the key is acknowledged and PET is now 
searching for data on the tape. In a few seconds (about 5-10) you will 
see: 



LOAD 

PRESS PLAY 0^ TAPf #1 

DK 

SEARCH I NO 



FOUND PROCHAJVt 
iOADIMG 



PET has found a program on the tape and is transferring it from the 
cassette into its memory. This is the operation referred to as "loading 

When loading is complete, the program will automatically begin 
executing. Also, the cassette motor will be turned off. 

(We're assuming that your PET's program is labeled " 
PROGRAM" for the sake of this example. It could be 
labeled virtually anything else.) 
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Disclaimer on Software: 

The complex and extensive software of the PET computer 
has been thoroughly tested and is believed to be quite reliable. 
However, no responsibility is assumed by Commodore or your 
sales agent for inaccuracies. 



Commodore Invites You 
To Submit Y our Best Programs 

Commodore intends to publish a library of programs 
for your PET computer. This endeavor has already 
begun. 

We'd like to encourage PET users to submit original 
programs to us. Those programs that are accepted will 
earn a royalty for their developers. 

If you're interested in writing programs for distribu- 
tion, write to: 

Software Manager 
Commodore Business Machines 
901 California Avenue Palo 
Alto, CA 94304 

We'll be glad to send you suggestions on programming 
techniques, procedures for submitting programs, and 
some guidance in selecting programs. 
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Appendix 

1 . Error messages 

When an error occurs. PET returns to Command level and displays 
READY on its TV screen. Variable values and the program text remain 
intact, but the program cannot he continued using the CONT command. 
GOSUB and all FOR ... NEXT context is lost, insofar as the current run 
is concerned. 

When an error occurs in a program statement, the error message dis- 
play will indicate the line number in which the error occurred. 

When the error occurs in a direct, or command level, statement, no 
Tine number is displayed with the error message. 



Error Message 



What caused the error and how to fix it 
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CAN'T CONTINUE Attempt to continue a program when none 
exists, an error occurred, after a new line was typed into the 
program, or a correction was made to an existing line. 

Correct the error, then use a directed GOTO to get back into 
the program, or type RUN and start over. 

DIVISION BY ZERO Dividing by zero is an error. Check the expression 
used for the denominator in the offending arithmetic statement, 
then correct it so it can never he evaluated as q . 

ILLEGAL DIRECT Use of an INPUT, GET, or DEE statement as a 
direct command. 

Avoid using these statements as direct commands. 
ILLEGAL QUANTITY The parameter passed to a math or string 
function was out of range. "ILLEGAL QUANTITY" errors can 
occur due to: 



a. a negative matrix subscript, such as LET A (-1 ) = 0* b. 
an unreasonably large matrix subscript: X=A(65536)* c. 
LOG-negative or zero argument, as LOG(-X)** d. SQR- 
negative argument, as SQR(-4) e. At B if A is a negative 
value and B is not an integer. 

(It works if a constant is used instead of a variable, i.e., 

-4t B, because exponentiation is performed before unary 

minus.) 
f. A call to USR before the address of the machine language 

subroutine has been patched in. 



Error Message 



What caused the error and how to fix it 



^Subscripts must be equal to or greater than 0, and less than or equal to 65535. ** 
Be sure the argument is within the range of the function being used. 

NEXT WITHOUT FOR The variable in a NEXT statement corres- 
ponds to no previously executed EOR statement. 

The FOR part of a FOR ... NEXT loop must be inserted or the 
offending NEXT part of the loop must he deleted. Be sure the index 
variables are the sunk at both ends of the loop. 
Example: FOR I = I TO 10 
NEXT I 

OUT OF DATA A READ statement was executed but all of the 
DATA statements in the program have already been read. The 
program tried to read too much data or insufficient data was 
included in the program. 

Use the RESTORE: statement to restore the data so PET can 
read it again, or restrict the number of READs to the correct 
number of DATA elements, or add more DATA elements, or 
use a flag at end of data list check for it before reading. 

OVERFLOW The result of a calculation was too large to he represented 
in BASIC'S number format. (If an underflow occurs, zero is given as 
the result and execution continues without any error message being 
printed.) 

You requested a number greater than even PET can remember. Try 
asking for a smaller number. The largest possible number is 1. 
70141 183E+38. Change the order of your calculations. 

REDIMENSIONED ARRAY After a matrix was dimensioned, another 
dimension statement for the same matrix was encountered. This 
error often occurs if a matrix has been given the default 
dimension 10 because a statement like A( I)=3 is encountered and 
then later in the program, a 1)IM A( 100) 

is 
found. 
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Error Message 



What caused the error and how to fix it 



Check to see if you have used a GOTO to branch back to a statement 
preceding the DIM statement, or see if the DIM statement is inside a 
FOR . . . NEXT loop or a subroutine that will be executed more than 
once, or if you have used an array element before using the DIM 
statement. Make DIM one of the first lines in your program. 

RETURN WTTHOUTGOSUB A RETURN statement was encountered 
without a previous GOSUB statement being executed. 

Either insert a GOSUB or delete the RETURN. Maybe you fell 
through the program and should enter an END statement before 
the first subroutine to prevent falling through. 

STRING FORMULA TOO COMPLEX A string expression was 
too complex. 

Break up the string into two or more shorter expressions. 

STRING TOO LONG Attempt was made by use of the concatenation 
operator to create a string more than 255 characters long. Note 
that a number is printed as SPACE-NUMBER-CURSOR RIGHT. 
SUBSCRIPT OUT OF RANGE An attempt was made to reference a 
matrix element which is outside the dimensions of the matrix. 

This error can occur if the wrong number of dimensions is used in 
a matrix reference; for instance, LET A(1,1,1)=Z when A has 
been dimensioned DIM A(2,2). 

You must either increase the space you requested for the array ( 
change a DIM A(10) to a DIM A(20), for example) or alter the 
number of dimensions you asked for (change from DIM A(10,10) 
to DIM A(10,10,10) or from DIM B(10,10,10) to DIM B(10,10) 
for example). 

SYNTAX ERROR Missing parenthesis in an expression, illegal char- 
acter in a line, incorrect punctuation, etc. 

This one is hard to find, but easy to fix. Examine the 
offending statement carefully and insert or delete whatever is 
necessary. 

TYPE MISMATCH The left-hand side of an assignment statement 
was a numeric variable and the right-hand side was a string, or 
vice versa; or a function which expected a string argument was 
given a numeric one or vice versa. 
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Error Message 



What caused the error and how to fix it 



Can't mix statement types, so change one side of the assignment 
statement so it agrees with the other side (sides meet at the = 
sign). Check the function argument types and use the correct 
type (numeric or string). 

IJM)EFINED STATEMENT An attempt was made to GOTO, 
GOSUB or THEN to a statement which does not exist. 

Insert the necessary statement number or branch to another 
statement number. 

UNDEFINED USER FUNCTION Reference was made to a user- 
defined function which had never been defined. 

Define the function. 



FILE OPEN You have attempted to open a previously opened tile. 
Check logical file numbers (1st parameter in the OPEN state- 
ment) and be sure you use unique numbers for each file or close 
the file. File is now closed. 

FILE NOT OPEN You have attempted to read from, write to, or 
close a file not previously opened. 

Open the file. 

NOT INPUT FILE You tried to INPUT# from a file opened for 
writing. 

Reading requires a Q as the 3rd parameter of the OPEN state- 
ment. Read (0) is the default option. 

NOT OUTPUT FILE You tried to PRINT# to a file opened for 
reading. 

Writing to a file requires a I (or a 2 if you want an EOT at the end 
of the file) as the 3rd parameter in the OPEN statement. 

DEVICE NOT PRESENT You have attempted to open a file on a 
device which is 'invisible' to PET. 

Check device numbers (2nd parameter in the OPEN statement) 
and he sure the device is assigned and connected properly and 
turned on. 
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2. Basic commands 

Basic Commands and Statements 



COMMAND/ 
STATEMENT 

CLR 

CMD 

CONT 

GOTO 
FRE 



EXAMPLE 



END 
LET 

LIST 



LOAD 



NEW 



CLR 

CMDD 

CONT 

GOTOL 

PRINT FIRE (0) 



END 


LET A-2 


LIST 


LIST -L 


L)ST L-M 


L)STL 



LOAD 



LOAD "NAME" 
LOAD "NAME," D 



NEW 



PEEK 


PEEK(A) 


POKE 


POKE A,B 


PRINT 


PRINT A 




PRINT A$ 




PRINT #L,A 




PRINT #L,A$ 


RUN 


RUN 




RUN L 


SAVE 


SAVE 




SAVE "NAME" 




SAVE "NAME,",D 




SAVE "NAME,",D,C 


STOP 


STOP 


SYS 


SYS(X) 



PURPOSE 



m 



Sets variables to zero or null. 

Keep IEEE device D open to monitor bus. 

Continue program execution after a STOP 
command. No program changes permitted. 

Continue program execution at line L after 
a STOP command. Program changes are 
permitted. 

Returns number of bytes of available 
memory. 

Ends program. 

Assign a value to a variable. 

Lists current program. 
Lists current program through line L. 
Lists lines L through M of current program. 
Lists current program from line L to end. 

Loads next encountered program from 
built-in tape unit. 

Loads program NAME from built-in tape 
ye^ds program NAME from device D. 

Deletes current program from memory, 
sets variables to zero. 

Returns byte value from address A. 

Loads byte B into address A. 

Prints value of A on display screen. 
Prints specified string on screen. 
Prints value of A on logical file L. 
Prints specified string on logical file L. 

Begins execution of program at lowest 

line number. 

Begins execution of program at line L. 

Saves current program on built-in tape 

unit. 

Saves current program NAME on 

built-in tape unit. 

Saves current program NAME on device D. 

Saves program NAME on device D. C spec 

ifies EOF or EOT. 

Stops program execution. 

Complete control of PET is transferred to 
a subsystem at decimal address contained 
in the argument. 



Basic Commands and Statements (Continued) 



COMMAND/ 






STATEMENT 


EXAMPLE 


PURPOSE 


Tl$ 


TI$-"HHMMSS" 


Sets PET'S internal clock to real time. 


Tl 


PRINT Tl 


Displays number of 'jiffies' since PET was 
powered up or clock was zeroed. (A jiffy 
- 1 r'60 of a second.) 


USR 


USR(X) 


Transfers program control to a program 
whose address is at locations 1 and 2. X is 
a parameter passed to and from the 
machine language program. 


WAIT 


WAIT A,B,C 


Stops execution of BASIC until contents 




(Note' the WAIT com- 


of location A, ANDed with B and exclusive 




mand may not operate 


ORed with C, is not equal to zero. C is 




on your particular PET) 


optional and defaults to zero. 


CLOSE 


10 CLOSE L 


Closes logical file L. 


DATA 


10 DATA 1,2,3,4 


Specifies data to be read from left to right. 




20 DATA TOM, SUE 


Alphabetics do not need to be enclosed in 
quotes. 




30 DATA "TOM DOE" 


If strings contain spaces, commas, colons, 
or graphic characters, the string must be 
enclosed in quotes. 


DIM 


lODIMA(n) 


Specifies maximum number of elements 
in an array or matrix. 




20 DIM A(n,m,o,p) 


Specifies maximum number of dimensions 
in an array. 




30DIM A(o),B(m) 


Number of arrays limited by memory. 




40 DIM Aft 


May be dimensioned dynamically. 




50 DIM A$(n) 


Strings may be dimensioned. 


END 


999 END 


Terminates program execution. 


GET 


10 GET C 


Accepts single numeric character from 
keyboard. 




20 GET C$ 


Accepts single string character from 
keyboard. 




30 GET #L,C 


Accepts single character from specified 
logical file. 




40 GET #L,C$ 


Accepts specified single string character 
from logical file. 


INPUT 


10 INPUT A 


Accepts value of A from keyboard. 




20 INPUT A$ 


Accepts value of string variable A from 
keyboard. The string does not have to be 
enclosed in quotes. 




30 INPUT A,A$,B,B$ 


Accepts specified values from keyboard. 




40 INPUT #L,A 


Accepts value of A from logical file L. 




50 INPUT #L,A$ 


Accepts specified string from logical file L. 




60 INPUT #L,A,A$,B,B$ 


Accepts specified values and strings from 

logical file L. Strings do not have to be 
enclosed in quotes. 
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Basic Commands and Statements (Continued) 



COMMAND;' 
STATEMENT 



LOAD 



OPEN 



POS 



PRINT 



READ 



REM 



RESTORE 



TAB 



VERIFY 



EXAMPLE 

10 LOAD 

20 LOAD "NAME" 

30 LOAD "NAME",D 
10 OPEN L 

20 OPEN L,D 

30 OPEN L,D,C 

40 OPEN L,D,C,"NAME" 

10 PRINT POS(O) 



10 PRINT A 
20 PRINT AS 
30 PRINT A,A$ 



40 PRINT A;A$ 

50 PRINT #L,A 
60 PRINT #L,A$ 

10 READ A 

20 READ AS 

30 READ A,A$,B,B$ 

10 REM "COMMENT" 

10 RESTORE 

10 PRINT TAB(N);A 

20 PRINT TAB(N);A$ 

1 2 ERIFY 

20 VERIFY "NAME" 



PURPOSE 

Loads next encountered program or file, 
on built-in tape unit, into PET's memory. 
Loads program or file NAME into memory 
from built-in tape unit. 
Loads specified file NAME from device D. 

Opens logical file L for read only from 

built-in tape unit. 

Opens logical file L for read only from 

device D. 

Opens logical file L for command C from 

device D. 

Opens logical file L on device D. If device 

D accepts formatted files, file NAME is 

positioned for command. 

Prints next available print position (posi- 
tion of cursor on screen I. 

Prints value of A on display screen. 

Prints specified string on screen. 

Prints specified values or strings on screen, 

beginning in next available print position 

(pre-TABbed positions are in 

columns 10,20,30,40, etc.). 

Prints on specified values and strings on 
screen separated by 3 spaces if numeric, 
concatenated if string. 

Prints specified value on logical file L. 

Prints specified string on logical file L. 

Obtains value of A from a DATA 

statement. 

Obtains string value of A from a DATA 

statement. 

Obtains specified values for strings and 

numeric variables from DATA statements. 

Inserts non-executable comments in a 
program for documentation purposes. 

Permits re-reading of DATA statements 
without re-running program. 

Prints value of A in character position 
N + 1 on screen. 

Prints string beginning in character 
position N + 1 on screen. 

Verifies most recent program saved on 
built-in cassette by reading it and com 
paring it with program still in PET's 
memory. 

Verifies specified program NAME saved 
on built-in cassette by reading it and 
comparing it with program still in 
PET's memory. 
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Basic Commands and Statements (Continued) 



COMMAND? 
STATEMENT EXAMPLE 



PURPOSE 



30 VERIFY "NAME",D 

Spc lOSPC(N) 

FOR . . NEXT 10 FOR A" 1 TO 20 

90 NEXT A 
STEP 10 FOR A - 1 TO 20 51 EP 2 

90 NEXT A 
IF ... THEN 10 IF A = 10 THEN PRINT A 

IF ... GOTO 10IFA=1 GOTOL 



Verifies specified program NAME saved 
on device D by reading it and comparing 
it with program still in PET's memory. 

Prints N spaces or blanks. 

Loop control. Performs all instructions 
between FOR and NEXT as many times 
as specified by index. In this example, 
*,he index variable is A. 

Step specifies size of increment to be 

Wm^x to increase or decrease its value 
towards the desired number of iterations. 



If condition is 'TRUE,' instruction 
fRi/oT'HEN' (in this example, 'PRINT A' 

) 

would be executed. Otherwise, the next 

statement in sequence is executed. 

l&%^'^4'iti@B i^ir,u©trf¥}^ir^,'^b'm*^^ed 

statement, following the ) F . . GOTO, 
is executed 



GOTO 



10 GOTOL 



GOSUB 10 GOSUB L 



ON ... GOTO 10ON AGOTOL,M,N 



ON.. . GOSUB 10 ON A GOSUB L,M,N 



RETURN 9990 RETURN 



Transfers control (jumps) to specified 
skippmg over mtervenmg Imes. 

Begins execution of a subroutine which 
begins on a specified line. 

Transfers control to specified line (in this 
example, L,M, or N, depending on value 
of index A. 



Begins execution of subroutine which 

begins on line L,M, or N, depending on 
the value of index A. 



Subroutine exit; transfers control to the 
statement following most recent GOSUB 
directing transfer to the subroutine. 



String Functions 



FUNCTION EXAMPLE 



PURPOSE 



ASC 


10A=ASC("XYZ") 


CHRS 


10 A$ = CHR$(N) 


LEFTS 


10 ?LEFT$(X$,A) 


LEN 


10 ?LEN(X$) 



Returns integer value corresponding to 
ASCII code of first character in string. 

Returns character corresponding to ASCII 
code number. 

Returns leftmost A characters from 

string. 

Returns length of string. 
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string Functions (Continued) 

FUNCTION EXAMPLE 



PURPOSE 



MID$ 



10 ?MID$(X$,A,B) 



Returns B characters from string, starting 
witin tine Atii ciiaracter. 

Returns rigiitmost A ciiaracters from string, 

Returns string representation of number. 

Returns numeric representation of string. 
If string not numeric, returns "0". 

ASC, LEN and VAL functions return numerical results. They may be used as part of an 
expression. Assignment statements are used here for examples only; other statement types 
may be used. 

Arithmetic Functions 



RIGHTS 


10 ?RIGHT$(X$,A) 


S1R$ 


10 A$ = STRS(A) 


VAL 


10 A-VAL(A$) 
20 A = VAL("A") 



FUNCTION 



ABS 
ATN 

COS 
DEF FN 

EXP 
INT 



LOG 



RND 



SGN 

SIN 

SQR 
TAN 
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EXAMPLE 



PURPOSE 



10 C=ABS(A) 
10 C = ATN(A) 

10 C=COS(A) 

10 DEF FNA(B)-C*D 

10 C-EXP(A) 

10 C=INT(A) 
10 C = LOG(A) 

10 C-RND(A) 



10 C-SGN(A) 

10 C=SIN(A) 

10 C = SQR(A) 
10 C TAN(A) 



Returns magnitude of argument without 
regard to sign. 

Returns arctangent of argument. C will be 
expressed in radians. 

Returns cosine of argument. A must be 
expressed in radians. 

Allows user to define a function. Function 
label A must be a single letter; argument B 
a dummy. 

Returns constant 'e' raised to power of the 
argument. In this example, eA. 

Returns largest integer less than or equal 
to argument. 

Returns natural logarithm of argument. 
Argument must be greater than or equal 
to zero. 



Generates a random number between zero 
and one. If A is less than 0, the same nega 
tive random number is produced in each 
call to RND. If A = 0, the same positive 
sequence of random numbers is generated 
each time RND is called. If A is greater 
than 0, a new sequence is produced for 
each call to RND. 



Returns -1 if argument is negative, returns 
if argument is zero, and returns +1 if 
argument is positive. 

Returns sine of argument. A must be 
expressed in radians. 

Returns square root of argument. 

Returns tangent of argument. A must be 
expressed in radians. 



Arithmetic Operators 



SYMBOL 



EXAMPLE 



PURPOSE 



AND 



OR 



NOT 



10A=B 

20 LET A=B 

30 PRINT A|2 

35 C=A/8 

40 C=A*8 

50 C=A+B 

60 C=A-8 

10 IF A = B THEN PRINT C 

10 IF A<-'BTHEN C = 4 
10 IF A<B THEN C$ = "X" 
10 IF A>BTHEN C$ = D$ + E$ 
10 IF A< =BTHEN C = 20 
10 IF A-- = BTHEN C=D-1 
10 IF A AND B THEN C = 

20 IF A OR B THEN C = 90 



Assigns a value to a variable. 
Let is optional. 

Exponentiation; in example, A^. 
Division 

Multiplication 

Addition 

Subtraction 

A 'equals' B. 

A 'does not equal' B. 

A 'is less than' B. 

A 'is greater than' B. 

A 'is less than or equal to' B. 

A 'is greater than or equal to' B. 

A and B must BOTH be true for statement 
10 to be true. 

A must be true or B must be true for 
statement 20 to be true. 



30 IF NOT A THEN PRINT C Expression is true if A is false. 



"NOTE The numerical values used in the evaluation of logical comparisons are: 'TRUE' is any 
non-zero number and 'FALSE' is zero. 



Special Symbols, Commands and Statements 



SYMBOLS, 

COMMANDS, 
STATEMENTS EXAMPLE 



10A=1:8=2:C=3 
10 PRINT A;B 

20 PRINT A$;B$ 
10 PRINT A,B 

LOAD "NAME,",D 
10 ?A 



PURPOSE 

Allows multiple statements on a line. 

Allows same line printing. Elements are 
separated by a space. 

Allows same line printing. String elements 
are concatenated. 

Allows same line printing. Elements are 
separated and printed in pre-TABbed print 
positions (columns 11,21,31, etc.) 

Separates elements in LOAD, SAVE, 
OPEN, and VERIFY. 
Abbreviation for PRINT. Stores as one 
character; lists as word PRINT. Do not 
use for PRINT #. 
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Special Symbols, Commands and Statements (Continued) 



SYMBOLS, 
COMMANDS, 
STATEMENTS EXAMPLE 



PURPOSE 



$ 10 A$-"ABCDEFG" String identifier. % 10 A%=INT(X) Integer 
identifier. 



10A$="ABCDEF" 



String enclosures. 



carriage return Must follow every command, statement, or data entry; causes cursor to return 

to leftmost position on next lowest line. 
Signals "END OF INPUT LINE." 

TT(pi) Value of Pi: 3.1415927. 

I/O Commands 



SYMBOL 



COMMAND 



PURPOSE 



L=1 -255 

C=0: READ OPEN L,D,C Note: PET will not read past C=1: WRITE an EOT (end of tape) marker. 

C=2: WRITE AND PUT EOT at end of file. 

D=1 CASSETTE 

D=2 2ND CASSETTE 

D=4-15 IEEE BUSS 



3. Special keys 



SHIFT key is 
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The following keys, when pressed while the 
being held down, will perform the following 
funcffiJr©P 

LOADS and RUNS the next encountered 
program from the built-in tape unit. 



Clears print from screen and moves cursor to upper 
left corner of screen. Program statements and all 
variables are retained. 

Moves cursor one space up. Will not scroll off top of 
screen. Does not delete characters as it passes over 
them. 

Moves cursor one space left (backspace). Wraps 
around to rightmost position on next highest 
line. Does not delete characters as it passes over 
them. 



Resets reverse field printing to normal printing. 

Inserts a space immediately in cursor position. All 
characters to right of inserted space are moved one 
space to right. Stops when 80th character is 
filled. 



It 

41 



C'llKlkltl 



OFF 
ftVS 



E 



INST 
DEL 



When the SHIFT key is not pressed, the keys will perform different functions, 
as indicated: 



Rm4 



Y 



CLR 
JK^ME 



f 



f ' 



r 



t I'KSOK 



OFF 
RVS 



INST 
DLL 



Stops execution of command in progress (LIST, 
LOAD, RUN, etc.). 



Returns cursor to upper left corner of screen. 



Moves cursor one space down. When cursor is at bot- 
tom of screen, print will scroll off top of screen. Does 
not delete characters as it passes over them. 

Moves cursor one space right. Will wrap around to 
left most position of next lowest line. Does not delete 
characters as it passes over them. 

Enables reverse field print (black characters on a 
white background). 

Deletes character immediately to left of cursor. All 
characters to right of deletion are moved one space 
left. Line is filled with trailing blanks if needed. 



4. Cleaning your PET 



With power switch in "OFF" position, gently wipe keytops with a 
shghtly damp cloth. Do not flood with water. 

Use any of the available lens-cleaner sprays to clean the video screen. 
Spray screen lightly, and dry with a soft, non-linting cloth or tissue. 

Wipe the cabinet with a soaped, well-wrung sponge. Do not 
use any commercial abrasive cleaners. Rinse by wiping with clean, 
slightly damp sponge or soft cloth. Do not immerse in water. 

Clean the recorder unit inside by touching dust particles with slightly 
damp cloth or sponge. Do not wipe surface ... cloth will snag on metal 
or plastic parts and may cause breakage. (See next section for more 
detailed instructions.) 

The outside of the recorder unit may be cleaned in the same manner 
as the keytops. 
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5. Cleaning and demagnetizing 
your tape deck head 

To be performed every 50-100 hours of tape running time or when 
cassette unit tails to read tapes reliably. 

You'll need the following tools and materials: 

I) Tape head cleaner. ("NORTRONICS" Brand is recommended.) Do 
not use Tricloroethane or any other plastic or rubber solvent. 
Alcohol may be used in an emergency, but is not recommended for long 
term use. 

Cotton Ss abs. "Johnson & Johnson" Brand is recommended: the 
cotton seems to stick to the end of the swab better. 

3) Tape Head Demagnetizer: "NORTRONICS," "HAND-DE-MAG" 

and "ROBINS" brands are recommended. Unit must have protective 
plastic or rubber covering on pole piece so as not to scratch delicate 
head gap. 

HOW TO PROCEED: 

1) Turn Off PL T. 

2) Press PLAY on tape deck to make heads available. 

3) Use tape head cleaner and one side of a cotton swab to clean surfaces of 
RECORD/PLAY (RIP) and erase head. (See Figure 7.) 

Scrub gently, noting if there is any build-up of tape oxide 
particles on or around head gap of the R/P head. If so, this is 
sufficient reason for unreliable performance. 

Also clean pinch roller and other tape bearing surfaces if tape 
head cleaner is suitable for this purpose. (Check label.) 

4) Plug in demagnetizer and activate it while it is at least one foot 

away from cassette heads. 

5) Slowly move demagnetizer up to RIP head and around on head 

surface. Rate of motion should he approximately one inch per 
second during this time. 

6) Slowly move demagnetizer to erase head and then to all other 

ferrous metal surfaces which cone into proximity with the tape. 

7) Now slowly move demagnetizer away from heads and do not 



de-activate field until demagnetizer is at least two feet away from 
heads. 

Tape head cleaning and demagnetizer procedure is now complete. 
Inspect R/P head surface for wear. If tape has worn a groove on head 
surface more than a Couple of tape thicknesses deep and program 
reading performance is still poor, then replacement of tape head is 
indicated. (This usually occurs after three thousand or more hours of 
tape running time.) 



HiAD&AFAilfA 
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AN IMPORTANT NOTE TO ALL PET OWNERS 

Create PET programs for fun and profit ... 

But make sure you deal with Commodore directly. 

We at Commodore encourage you, the PET user, to subm^it program^s to 
us. These programs, when accepted by us, will earn royalties for you on 
each program sold. So you can now create program^s for fin and profit. 

Just subm.it your program,, after checking it out thoroughly on your 
PET, to the 

Software Program Manager 
901 California Avenue 
Palo Alto. CA 94304 

This is the only address if you want Com,m,odore to evaluate and 
distribute your program,. It's been brought to our attention that 
som,e free-lance operators are soliciting PET users for program^s and 
implying that they represent Com,m,odore, 

Absolutely not so! Comm,odore is not represented by any user club 
or newspaper. The only address for Com,m,odore PET program, infor- 
m,ation or sales in the United States is Com,m,odore at 901 California 
A venue in Palo .Alto. 

So, protect yourself. We want your pro gram,s. And we know you 
want to m,ake sure you're dealing with Com,m,odore directly. 
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